home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / thor / thor_2.4 / thor.lha / Docs / THOR.FAQ < prev    next >
Text File  |  1996-11-11  |  17KB  |  401 lines

  1. $Id: thor.faq 1.5 1996/10/08 11:57:44 pettern Exp pettern $
  2.  
  3. - Download speed DMA contention etc.
  4. =======================================================================
  5.                    THOR Frequently Asked Questions
  6.                        Last updated 24 Sep 1996
  7.  
  8.                             Maintained by:
  9.                   Petter Nilsen (pettern@icenet.no)
  10.  
  11. =======================================================================
  12.  
  13. General:
  14. ~~~~~~~~
  15.    1.1  What is this 'system' you talk about all the time?
  16.    1.2  "Failed to load the configuration datafiles."
  17.    1.3  "Systems Config -> Type" is empty.
  18.    1.4  When I quit THOR, it doesn't free all the memory used.  Why?
  19.    1.5  "waitforport" in ARexx scripts fail from within THOR.
  20.    1.6  Multiuser filesystem (MuFS) problems with THOR.
  21.    1.7  Moving the database correctly.
  22.    1.8  Waitpointer is "hanging" after some operation.
  23.    1.9  Adding messages to the database is slow.
  24.    1.10 How to repair broken or damaged message databases.
  25.    1.11 How to snapshot the window positions.
  26.    1.12 XPK/DiskExpander problems
  27.    1.13 Where to get the latest versions of THOR.
  28.    1.14 What is the latest version of THOR?
  29.    1.15 How do I save several messages in a single operation?
  30.    1.16 My list of events doesn't seem to clear.
  31.  
  32. Internet:
  33. ~~~~~~~~~
  34.    2.1  Password is not accepted at a POP host
  35.    2.2  ConnectTHOR still running after being closed with the close
  36.         window gadget.
  37.    2.3  What is socket.library?
  38.    2.4  "Could not open socket.library".
  39.    2.5  "domain name missing.." when sending mail.
  40.    2.6  Error message when trying to select a newsgroup to join.
  41.    2.7  Collecting mail with SMTPd instead of POP3.
  42.    2.8  "Connection refused" when using "Get Mail".
  43.    2.9  How do a send a carbon copy of a mail to several users?
  44.    2.10 How do a get a list of newsgroups from the newsserver?
  45.    2.11 "You must configure e-mail address for the system..."
  46.    2.12 The progressbar's total counts down on newscollection.
  47.  
  48. -----------------------------------------------------------------------
  49. 1.1 - What is this "system" you talk about all the time?
  50.  
  51. To put it simple, a system is either a particular BBS, an Internet
  52. provider or a Fido site.  You can use THOR to read messages or
  53. postings from many systems.
  54.  
  55. -----------------------------------------------------------------------
  56. 1.2 - "Failed to load the configuration datafiles."
  57.  
  58. 1.  Since the message database is located on disk, it is sensitive to
  59. whatever might happen to the disk.  In case of a disk crash or similar
  60. problem, use one of the commercial or shareware tools that can fix
  61. such problems.  DiskSalv, Quarterback Tools or AmiBack Tools are all
  62. recommended for this purpose.
  63.  
  64. 2.  One or more of the datafiles that THOR needs might be corrupt or
  65. damaged.  Take a backup of your database, then use BaseManager to fix
  66. the problem.  If not even that helps, you may have to delete the
  67. conference (or in the worst case, the whole system and make a new
  68. one).  It might help to copy the .bak file for the reported failed
  69. file over the original.
  70.  
  71. 3. If the IoErr: value is 103, you do not have enough memory to start
  72. THOR. 
  73.  
  74. See also "Repairing a damaged database".
  75.  
  76. -----------------------------------------------------------------------
  77. 1.3 - When I try to configure a new system, the "Type" gadget is empty.
  78.  
  79. THOR isn't installed correctly.  Re-run the installation, reboot and
  80. try again.  If you don't want to install again, you might execute the
  81. cfg* scripts i <YourThorDir>/s/ from shell with the command "execute".
  82.  
  83. -----------------------------------------------------------------------
  84. 1.4 - When I quit THOR, it doesn't free all the memory used.  Why?
  85.  
  86. bbsread.library uses a buffering system.  The buffers will not be
  87. freed immediately by the library.  The library will flush the buffers
  88. after 5 minutes if the library isn't used anymore.  You can flush the
  89. library manually with the "avail flush" command, but AmigaOS will
  90. automatically flush the library from memory when the memory is needed
  91. by some other program if the library is not in use anymore.
  92.  
  93. -----------------------------------------------------------------------
  94. 1.5 - "waitforport" in ARexx scripts fail from within THOR.
  95.  
  96. Associated problems:
  97. THOR does not find programs I start from within THOR, like the
  98. ThorStat program, even if the directory these programs reside in is in
  99. my path.  I have made sure I have the correct path statement in my
  100. user-startup.  What it wrong?
  101.  
  102. Answer:
  103.  
  104. If you have made sure you use the ADD keyword to the path command in
  105. your user-startup and that this directory actually exists, one
  106. possible reason might be that you start THOR as a WB Prosess from
  107. ToolManager.  The WB Startup code in ToolManager is buggy and ignores
  108. any path, so you should start THOR as a CLI prosess from ToolManager
  109. instead (WBStart-handler 1.4 included with ToolManager 2.1a fixes this
  110. problem).  THOR will inherit the path even if started from Workbench
  111. since THOR converts itself to a cli prosess on startup.
  112.  
  113. ParM will show simular (bad) behaviour when started from WB, so start
  114. if from CLI whenever possible.
  115.  
  116. -----------------------------------------------------------------------
  117. 1.6 - Multiuser filesystem problems with THOR.
  118.  
  119. Due to a bug in MultiUsers handling of async lowlevel dos packets, the
  120. files in all THOR's datadirs must be set up without any user or group.
  121. This can be done with the following command:
  122.  
  123. mprotect `getenv thor/bbsdatapath` RWD group RWD other RWD all
  124.  
  125. -----------------------------------------------------------------------
  126. 1.7 - Moving the database correctly.
  127.  
  128. Sometimes  it might be useful to move the THOR installation to another
  129. disk  or  somewhere  else  on  the same disk.  This can be done in the
  130. following fashion:
  131.  
  132. 1. Make sure you are not running THOR and flush the memory with the
  133.    command "avail flush" from a shell.
  134.  
  135. 2. Move the database to wherever you want it.
  136.  
  137. 3. Change envarc:THOR/THORPath to point to the new directory you have 
  138.    THOR in.
  139.  
  140. 4. Change envarc:THOR/BBSReadPath to point to the new directory you
  141.    have you database. The database is usually stored in a "data"-subdir
  142.    under the THOR directory.
  143.  
  144. 5. Reboot.
  145.  
  146. -----------------------------------------------------------------------
  147. 1.8 - Waitpointer is "hanging" after some operation.
  148.  
  149. This can happen with certain commodities that change the mouse pointer
  150. in  various ways.  Particular older programs (eg.  QMouse) is known to
  151. not handle this correctly.  Try running without these programs.
  152.  
  153. -----------------------------------------------------------------------
  154. 1.9 - Adding messages to the database is slow.
  155.  
  156. Several things can be done to speed this up:
  157.  
  158. - Turn off the "Add Users" option on the system in question in Systems
  159.   Config -> Import/Export.
  160.  
  161. - Open  the  user database window and delete all the users you do not
  162.   want in the database. Then select Maintenance in this same window.
  163.  
  164. - Set up more buffers and higher buffer size in Global Config -> 
  165.   Database options. 15 buffers on 15K is a good setting if you can
  166.   afford to use that kind of memory.
  167.  
  168. - If you use XPK packing, turn off "Auto XPK packing" in 
  169.   Global Config -> Database options.
  170.  
  171. -----------------------------------------------------------------------
  172. 1.10 - How to repair broken or damaged message databases.
  173.  
  174. If  you  experience  problems adding messages to the database, reading
  175. messages or other related problems, follow these steps:
  176.  
  177. - Make sure you are not running THOR and flush the memory with the
  178.   command "avail flush" from a shell.
  179.  
  180. - Run the program "basemanager" with the validate switch:
  181.  
  182.   bin/basemanager validate <systemname>
  183.  
  184.   eg. bin/basemanager validate "news&mail"
  185.  
  186. - Use the ARexx script "CheckDatabase.br" with the DELETE switch:
  187.  
  188.   rx rexx/bbsread/checkdatabase.br <systemname> DELETE
  189.  
  190.   eg. rexx/bbsread/checkdatabase.br "news&mail" DELETE
  191.  
  192. - Now, enter the conference with a problem with THOR and make sure
  193.   you have the message list window open. Multiselect (with the shift
  194.   key) all messages with "*BAD DATA*" or "Failed to get message data"
  195.   and then select Delete msgs from the menu.
  196.  
  197. - When you have preformed the steps above, select "pack/purge" on
  198.   this system from within THOR or use the "bin/packbbs" program.
  199.  
  200. -----------------------------------------------------------------------
  201. 1.11 How to snapshot the window positions.
  202.  
  203. Select "Visual Options" from the Configuration menu and then "Save".
  204.  
  205. -----------------------------------------------------------------------
  206. 1.12 XPK/DiskExpander problems
  207.  
  208. - DiskExpander is very buggy and should not be used under any
  209. circumstances until it has been updated.  AFAIK, the authors are
  210. "working" on fixing the known problems with DE.
  211.  
  212. - XPK packing is supported directly in THOR, and this is more
  213. efficient than running THOR on a partition with XPK.  However, there
  214. seem to be problems when using RAKE as compressior, but later NUKE
  215. versions has been tested and works fine.  If you have a problem with
  216. RAKE or any other methods, NUKE is generally a good alternative.
  217.  
  218. -----------------------------------------------------------------------
  219. 1.13 Where to get the latest versions of THOR.
  220.  
  221. The latest versions and fixes can always be found for ftp at
  222. ftp://hstud6.cs.uit.no/pub/thor/ and ftp://thule.icenet.no/pub/thor/,
  223. and on our mirror ftp site at ftp://ftp.demon.co.uk/pub/mirrors/thor/thor/.
  224.  
  225. THOR World Wide Web site: http://www.cs.uit.no/~kjelli/thor.html
  226.  
  227. These sites might contain fixes, ARexx scripts etc. not released on
  228. Aminet.
  229.  
  230. -----------------------------------------------------------------------
  231. 1.14 What is the latest version of THOR?
  232.  
  233. THOR 2.31 is the latest version and this is an upgrade to 2.3. A new
  234. utgui.library that fixes compatibility problems with OS 2.x is also
  235. available at our ftp site.
  236.  
  237. -----------------------------------------------------------------------
  238. 1.15 How do I save several messages in a single operation?
  239.  
  240. Open the message list window and select the messages to save with the
  241. mouse while holding the shift key in. Then select save from the menu
  242. and all the selected messages will be saved to the same file.
  243.  
  244. -----------------------------------------------------------------------
  245. 1.16 My list of events doesn't seem to clear.
  246.  
  247. Open the event edit window and check for events with FRZ and ERR in
  248. front of them. When these are gone (eg. deleted), the list will be
  249. cleared the next time you send events from ConnectTHOR.
  250.  
  251. -----------------------------------------------------------------------
  252. 2.1  Password is not accepted at a POP host
  253.  
  254. There are several reasons why a password might be rejected at the POP
  255. host when trying to collect mail:
  256.  
  257. - You are trying to get mail from a server you do not have an account
  258. on.
  259.  
  260. - You have some special characters like *#? etc. in the password. 
  261. Due to the way passwords are sent to GetTCP from ConnectTHOR, some of
  262. these special characters might be interpreted by AmigaDOS and changed.
  263. For instance, if you have a password with a '*' character in, make sure
  264. you pass in an extra '*'. Eg: "pass*word" becomes "pass**word".
  265. **** This problem was fixed in 2.3 of THOR. ****
  266.  
  267. - You have a password longer than 8 characters. Many POP servers do not
  268. accept passwords on more than 8 characters.
  269.  
  270. -----------------------------------------------------------------------
  271. 2.2  ConnectTHOR still running after being closed with the close
  272.      window gadget.
  273.  
  274.  
  275. ConnectTHOR is a commodity and normal behaviour on commodities is to
  276. hide the program and not quit it when using the close gadget in the
  277. window.
  278.  
  279. If you want to quit ConnectTHOR, use the Quit menu item instead.
  280.  
  281. -----------------------------------------------------------------------
  282. 2.3  What is socket.library?
  283.  
  284. socket.library is originally a library included with AS225r2 beta, a
  285. TCP/IP stack made by Commodore but never released to the public.
  286. However, since this is a nice and easy TCP/IP stack and a lot of
  287. developers use it, the THOR TCP programs have been programmed to use
  288. it.  If you use AmiTCP, like most do, you need the socket.library for
  289. AmiTCP that emulates the AS225r2 socket.library in a way that makes
  290. AS225r2 programs work.  This library is included with Grapevine, the
  291. IRC client, and can also be found on ftp://hstud6.cs.uit.no/pub/thor.
  292.  
  293. ***********************************************************************
  294. Starting from THOR 2.3, the TCP modules do not need this library to
  295. work with AmiTCP. 
  296. ***********************************************************************
  297. -----------------------------------------------------------------------
  298.  2.4  "Could not open socket.library".
  299.  
  300. Your socket.library is not installed correctly. Do the following:
  301.  
  302. - Assign inet: to Amitcp:, like this: "Assign inet: amitcp:"
  303. - Create a directory called "libs" in Amitcp: (if it doesn't exist
  304.   already).
  305. - Copy socket.library to Amitcp:libs.
  306. - Setup the SOCKETCONFIG file in envarc:/env: as described in the
  307.   socket.library documentation.
  308.  
  309. -----------------------------------------------------------------------
  310. 2.5  "domain name missing.." when sending mail.
  311.  
  312. Your socket.library is not correctly configured. Create a file in envarc: 
  313. and env:. Here's my file:
  314.  
  315. UID=100 GID=100 USER=pettern DOMAIN=icenet.no UMASK=002
  316.  
  317. Replace the USER with you username, and DOMAIN with your domain,
  318. and it should work fine.
  319.  
  320. -----------------------------------------------------------------------
  321. 2.6  Error message when trying to join a newsgroup.
  322.  
  323. Error message when trying to join a newsgroup:
  324.  
  325.   Failed to load the configuration datafiles.
  326.   Error in dh1:thor/data/bbs0/PassConf.Data.
  327.   Cause: Dos failure
  328.   IoErr reports 103
  329.  
  330. This error messages means that you do not have enough continues memory
  331. to load the large list of newsgroups into memory.
  332.  
  333. -----------------------------------------------------------------------
  334. 2.7  Collecting mail with SMTPd instead of POP3.
  335.  
  336. Some Internet providers do not provide POP3 mail.  Mail needs to me
  337. collected using a SMTP deamon in these cases, and the "Get Mail"
  338. function in ConnectTHOR can not be used.  However, THOR will read
  339. mailboxes created by any SMTPd just fine if you follow these steps:
  340.  
  341. - Set the download directory in Global Config->Paths to the directory
  342. where incoming mail is stored.
  343.  
  344. - Set the Mailpacket name in Systems Config to the name of the mailbox
  345. that is created by SMTPd and save.
  346.  
  347. THOR will now automatically import these mailboxes into its database
  348. when you enter the system configured for Internet.
  349.  
  350. Installation of the SMTP deamon is beyond the scope of this FAQ, see
  351. the supplied documentation for the SMTPd in question for how to do
  352. this.  INetUtils on Aminet includes a SMTPd that will work fine.
  353.  
  354. -----------------------------------------------------------------------
  355. 2.8  "Connection refused" when selecting "Get Mail".
  356.  
  357. See 2.1 and 2.7.
  358.  
  359. -----------------------------------------------------------------------
  360. 2.9  How do a send a carbon copy of a mail to several users?
  361.  
  362. You can send a carbon copy of a mail to several users using one of the
  363. following methods:
  364.  
  365. 1. In the to-address gadget, enter all addresses separated with a ','
  366. (comma).
  367.  
  368. 2. Use the popup gadget to select all the users from a list of users in the
  369. user database.
  370.  
  371. 3. Enter at the very top of the message text a "Cc:" line containing
  372. the addresses of the users to send a carbon copy to. Example:
  373.  
  374. Cc: user1,user2,user3
  375.  
  376. -----------------------------------------------------------------------
  377. 2.10 How do a get a list of newsgroups from the newsserver?
  378.  
  379. Select "Get Conf.List" from the Events menu, then select "Send Events"
  380. in ConnectTHOR and a list of newsgroups will be collected. This might
  381. take some time, so be patient.
  382.  
  383. -----------------------------------------------------------------------
  384. 2.11 "You must configure e-mail address for the system..."
  385.  
  386. If you get this message when sending mail, open the system
  387. configuration from THOR, select the system with the problem, then
  388. select the user info gadget. Enter your full email address in the
  389. email address field and select save. Try again.
  390.  
  391. -----------------------------------------------------------------------
  392. 2.12 The progressbar's total counts down on newscollection.
  393.  
  394. You might notice that the total value in the progressbar on getting news
  395. counts down.  This can be of various reasons, but the most normal reason
  396. is that an article is not available anymore on the newsserver due to
  397. cancellation. Another reason can be a short expire of articles on the
  398. server so that you do not have time to collect it before it's being 
  399. deleted.
  400.  
  401.